package com.ruoyi.circle.mapper;

import java.util.List;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.circle.domain.CircleMemberRelation;

/**
 * 圈子成员关系Mapper接口
 *
 * @author 区嘉盛
 */
public interface CircleMemberRelationMapper extends BaseMapper<CircleMemberRelation> {
    /**
     * 查询圈子成员关系
     *
     * @param id 圈子成员关系主键
     * @return 圈子成员关系
     */
    public CircleMemberRelation selectCircleMemberRelationById(Long id);

    /**
     * 查询圈子成员关系列表
     *
     * @param circleMemberRelation 圈子成员关系
     * @return 圈子成员关系集合
     */
    public List<CircleMemberRelation> selectCircleMemberRelationList(CircleMemberRelation circleMemberRelation);

    /**
     * 查询圈子成员列表（包含用户信息）
     *
     * @param circleMemberRelation 圈子成员关系
     * @return 圈子成员关系集合
     */
    public List<CircleMemberRelation> selectCircleMemberList(CircleMemberRelation circleMemberRelation);

    /**
     * 查询用户在圈子中的角色
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @return 成员角色
     */
    public Integer selectUserRoleInCircle(Long circleId, Long userId);

    /**
     * 查询圈子成员数量
     *
     * @param circleId 圈子ID
     * @return 成员数量
     */
    public int selectCircleMemberCount(Long circleId);

    /**
     * 新增圈子成员关系
     *
     * @param circleMemberRelation 圈子成员关系
     * @return 结果
     */
    public int insertCircleMemberRelation(CircleMemberRelation circleMemberRelation);

    /**
     * 修改圈子成员关系
     *
     * @param circleMemberRelation 圈子成员关系
     * @return 结果
     */
    public int updateCircleMemberRelation(CircleMemberRelation circleMemberRelation);

    /**
     * 删除圈子成员关系
     *
     * @param id 圈子成员关系主键
     * @return 结果
     */
    public int deleteCircleMemberRelationById(Long id);

    /**
     * 批量删除圈子成员关系
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteCircleMemberRelationByIds(Long[] ids);

    /**
     * 根据圈子ID删除圈子成员关系
     *
     * @param circleId 圈子ID
     * @return 结果
     */
    public int deleteCircleMemberRelationByCircleId(Long circleId);

    /**
     * 检查用户是否已经是圈子成员
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @return 结果
     */
    public int checkUserIsCircleMember(Long circleId, Long userId);

    /**
     * 更新圈子成员状态
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @param memberStatus 成员状态
     * @return 结果
     */
    public int updateMemberStatus(Long circleId, Long userId, Integer memberStatus);

    /**
     * 更新圈子成员角色
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @param memberRole 成员角色
     * @return 结果
     */
    public int updateMemberRole(Long circleId, Long userId, Integer memberRole);
    
    /**
     * 设置用户黑名单状态
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @param blacklistStatus 黑名单状态（0-正常 1-黑名单）
     * @return 结果
     */
    public int updateBlacklistStatus(Long circleId, Long userId, Integer blacklistStatus);
    
    /**
     * 检查用户是否在圈子黑名单中
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @return 结果
     */
    public int checkUserInBlacklist(Long circleId, Long userId);

    int updateTransferOwner(Long circleId, Long userId, Integer memberRole);

    /**
     * 更新用户等级
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @param userLevel 用户等级
     * @return 结果
     */
    public int updateUserLevel(Long circleId, Long userId, String userLevel);

    /**
     * 检查用户是否已经是圈子活跃成员（状态为1）
     *
     * @param circleId 圈子ID
     * @param userId 用户ID
     * @return 结果
     */
    public int checkUserIsActiveMember(Long circleId, Long userId);
}